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GENERAL DESCRIPTION 


The 81800/81700 data communications subsysten provides an 
interface between the network controttler and any executing MCS on 
the systean. The character-oriented header information which the 
MCS reads or writes in its communication with the network 
controllers the resote files in its oun netuork>s and the MCP 
constitutes» basically» the MCS interface that is cescribed in 
this product specification. MCS interface» then» is composed of 
the various messages required for any queries or changes in the 
status of remote stations. 


This datacocnm environment requires» at minimums an NOL handter 
end a user program which opens a remote file with headers Can 
HCS)- There is no eestriction on the number of remote files with 
headers that may be opened on the systems aithough there is a 
gmaxigum of 20 remote files that can be concurrentiy asscciated 
with any one station. In a system composed of several MCSs» a 
Station gay be associated with sore than one of them in a 
hierarchicad manner. 


In generals» the network controtter handles the line protocot and 
the MCS» in cooperation with the network controller» handles the 
attachment of remote stations to their respective retote fiies. 
Remote file [/0» jas is standard on 81800/B81700.§ systense is 
controtlied by the operating system through a queue file mechanisa 
that is transparent to the user and is not a concern of this 
document. 


An MCS) program will ful fill some or all of the following data 
communications needs: 


“- Message switching 


= Logical attachreent of a station to a renote application 
progras or system of programs 


- Network reconfiguration 
= Audit and recovery 
- Network statistical anaiysis 


- Comagunicate with the operating systen. 


RENOTE FILES 


Remote files are the means by which progrargs use the NOL data 
comfunications subsystem to transfer information fron rencte 
terminats to user progrargs Cor vice versa}s» and MCS-type rencte 
files are distinguished from ordinary remote files only by the 
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speciat headers that aiflow them to affect the fiow of messages. 


MCS interface is enabted by opening a renote file with headers 
that has an external file name which matches a file declared in 
the file section of the executing network controiler. Att 
stations listed in the family statement for that file are 
controiied by the MCS. The SO-byte header that precedes data 
gsessages atltows the MCS to access tallies» toggies and cther 
information relevant to the originating station of the message. 
Non~data messages consist onty of the variable-length header. 


Oummy remote files» tive.» with no stations specifieds are ailowed 
providing that the progras opening the dumsy remote file Cwithout 
headers) has been zip~executed by an MCS*type progran. The MCS 
ts expected to direct the assignment of stations to that file by 
approving or disapproving the open of any remote station that 
wishes to be attached to that file. 


RESOURCE SHARING 


Where sultipie MCSs are executing on the same system» there is an 
established protocot which allows one MCS to attach stations to 
another. The protccoi is based upon the concepts of “prisary* 
and “secondary” and these terms refer to the relative 
responsibilities of two MCSs in the controi of a remote station. 


Since users may sign on ofr attach to a series of MCS~-type files» 
primary files» with some restrictions noted bealows are 
distinguished from secondary files onty by signal characters and 
by their relative positions in the master tist of attachsents 
kept for each station in the remote network. The primary fite is 
the last remote file on the master List to which the staticn is 
attached and the secondary file is the next-torclast. Gy defaults 
att interface messages go to the primary files ands if the first 
character of the message matches the signal character defined for 
the secondary file Calt secondary files must have a signal 
character)»e the message goes to the secondary file. The 
advantage of this configuration is that a remote station can 
stilt communicate with the secondary fite even though it has a 
primary attachment to another reaote file. 


Secondary files» thene are cestricted to remote files opened with 
headers since they must have signal characters associated with 
theme and prinary files say be either ordinary reaote files or 
remote files opened with headerse In a sertes of remote 
attachments done by an individual station» there is a limit of 
one attachawent to a remote file without headers: it must be the 
primary file. If ati of the attachnents are to MCS-type remote 
files» there is a Limit of 20 attachments for one resote station. 


Peinary and secondary protocot ts raintained through a master 
Cist that is updated by the network controtler each tine a renote 
Station attaches or detaches itsetf from an MCS or a remote file. 
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When a station signs on or attaches to a remote filer the 
file-name is added to the list and a signat character is 
associated with it» if it is an MCS. If a third attach/sign on 
is madees the primary and secondary designations are reconfigureda. 
After redefinitions the original MCS does not have any current 
responsibilities where the remote station is concerned and iss at 
this points inaccessible from that station. 


When a remote station is detached or closed» the last entry is 
deteted from the List and primary and secondary are reconfigured 
from the waster list. In this ways» the original MCS Cin a series 
of three attaches) is maintained on the tist and the final 
close/detach must be from the first Coriginalt) MCS. MCSs 
designed to inhibit the primary~secondary option do so by denying 
alt opens on renote files with headers. 


BASIC TERMINOLOGY 


This subsection defines most of the basic terminology that is 
used in this product specification. It also references celated 
publications that would be helpfui to those who are unfamiliar 
with those terms and concepts. .< 


HCS Message Control Systenan - Any proegrar 
which opens a remote file with the 
header option and thereby controts the 
stations in that remote file. 


NC Network Controller - The program 
generated through compitation of an NOL 
(Network Definition tanguage) progras. 
The NC handles the tine ciscipline far 
the data communication devices of a 
system and interface queue between MCS 
and operating system. Refer to P.S. 
2212 5223 81800/81700 NDL and 1073715» 
NOL Reference Manual. 


Revsote File A file dectared in a program which» in 
- conjunction with the network controller, 
provides input» output or [1/0 with a set 
of data communication devices. Refer to 
P.Se 2212 5462» 8B1800/81700 MCPII and 
10899925 Data Communications Information 
Manual. 


Headers An option on aremote file which allows 
system controt functions and prowides a 
S50“byte header on ail data messages 
aoving through that remote file. 


Priaary File The file to which a station was aost 
recently attachec or inctuced in an 
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Secondary File 


Controlling Remote File 


Attach Initiator 


User Program (U.P.) 


LSN 


RSN 
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open. Normal input goes to the prinary 
file. 


The file to which a station was just 
previously attached or included in an 
opens it.ee» the penuitimate attachment. 
The secondary file must have headers and 


widd have approved the attach or open of 


the primary file. Input whose first 
character matches the signal character 
Cnot biank) designated in the prirary 
file*s attach or open witl go to the 
secondary fite. 


CCRF) is the file with headers to which 
8 station was most recently assigned» 
either with an attach or with an open. 
If the primary file has headers» it is 
the CRF otherwiser the secondary fite 
is the CRF. 


is the file which writes an attach. 


normatily denotes a program which has 
opened or is opening a remote file 
without headers. 


Logical Station Number =~ The number by 
which the network coantrotler uniquely 
identifies a station for nersat 
transactions. LSN*s begin with %7001" 
and proceed sequentiatly through alt the 
Stations declared in the Station section 


of the ADL controlier. 


Relative Station Number - is the nusber 
by which a user program with a remote 
file using a remote key uniquety 
identifies a station. An RSN equal tc 0 
implies a control message.e. An RSN equal 
to 1 implies the first station in the 
file*s family statement. RSN*s preceec 
sequentially through the Stations 
delineated by a file*s family staterent> 
except that a controtling remote file 
may modify the ULSN-LIST and thereby 
modify the RSN*s of the remote file. If 
a station is detached fron a file with a 
remote keys the ARSN*s renain unchanged. 
If a station is attached to a file with 
aremote keys the new RSN witl be its 
old RSN if it were attached previoustys 
otherwise» it wiit be one targer than 
the greatest RSN previously associated 
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with the file. 


RELATED QOCUMENTATION 


NAME ee NUMBER 
B1600/B1700 Network Definition Language PeSe 2212 5223 
61600/81700 NDL/Library PeSe 2212 5215 
B1800/B1700 NOL Reference Manuat 1073715 
Oata Communications Reference Manuat 1089992 . 
B1600/B8i1700 Data Comm Audit PeSe 2212 5421 


81800/81700 MCPII PeSe 2212 5462 


et 
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MESSAGE TYPES 


This section specifies the record formats of the wessages read 
and written by the MCS as it communicates with both the network 
controller and the remote stations in its remote file. | 


There are three types of record formats: data» controt and 
user-defined. Data record format is used in the transfer of 
information between network controllers and remote stations and 
in this area the MCS may read or write the record» depending oan 
the source and destination of the message. Controt records are 
defined by name and represent a specific purpose and actions 
@eGese a detachereply. User-defined record format is used for 
cogsnmunication between an MCS and a user remote file without 
headers and» as its name indicates» it allows the user program to 
establish the purpose of the communication. 


Att messages read and written by an MCS are listed by type and 
format. 


MESSAGE TYPE FORMAT 
QUIPUT MESSAGE (from REMOTE FILE) 700" DATA 
INPUT MESSAGE (from STATION) "01" DATA 
INPUT LOGICALACK “02 DATA 
GOOD.RESULTS-REPLY #95" DATA 
RECALLED. MESSAGE "06" DATA 
UNPROCESSED.OUTPUT MESSAGE “07° DATA 
OPEN 10" CONTROL 
ATTACH | "12° CONTROL 
ATTACH.REPLY 13" CONTROL 
DETACH | . m14" CONTROL 
DETACH.REPLY "15" CONTROL 
CLOSE : "16" CONTROL 
STATUS.REPLY #21" CONTROL 
CHANGE. REPLY "23" CONTROL 
RECALL-REPLY "25" CONTROL 
REMOVE. REPLY “27% CCNTROL 
REMOTE.FILE.INFO.REPLY "29" CONTROL 


REMOTEsFILE.INTERCOMMUNICATION 750% = *99° USER-DEFINED 
Table 2.1 MESSAGES READ 


HESSAGE TYPE FORMAT 


OUTPUT MESSAGE (to STATION) 7007 | DATA 
INPUT MESSAGE (to REMOTE FILE) — =01" DATA 


LOGICALACK»REPLY QZ DATA 
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OUTPUT GOOD.RESULTS “04° DATA 

GPEN.~REPLY erie ~ CONTROL 

ATTACH “12° CONTROL 
ATTACH.REPLY | “13" CONTROL 

DETACH "14" CONTROL 

STATUS : *20° CONTROL 

CHANGE "22° | CONTROL 

RECALL “24" CONTROL 

REMOVE . "26° CONTROL 
REMOTE-FILEINFO "28" CONTROL 


REMOTE«FILE«INTERCOMMUNICATION "SQ" = "99" USER-DEFINED 
| Table 2.2 MESSAGES WRITTEN 


REY [9 ABBREVIATION 
In Tables 2.3 through Sel» the following abbreviations and 
notations are used: 


NC Network controller/operating system interface 


MCS ~ Remote file nith HEADERS 
USER =~ Remote fide without HEADERS 
R = Read 
u @- Write 
Note: 


"s«" under a “W" inplies that it is appropriate for that progran 
to SET that fieid. 

fe" under an “*R*® implies that it is appropriate for that prograrn 
to READ that fietd. 

- *#" under a "“W" jiaplies that it is mandatory for the MCS to SET 

that field before sending the message. 

“9° implies a numeric EBCDIC character fieid (Bit 8) 

“X" implies an EBCDIC character field (Bit 8) 

“#" denotes iterations of the same fieid» one for each 
resote station : 


5=1 


BURROUGHS CORPORATION . COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP MESSAGE CONTROL SYSTEM INTERFACE 


SANTA BARBARA PLANT 


Fe Se 2212 S447 (C) 


“PATA MESSAGES © 


The types oaf data messages which an MCS reads and writes are as 


follows: 


TYPES WRITTEN 


00 


01 


03 


04 


TYPES READ 


00 


01 


02. 


DESTINATION AND FUNCTION 


@@[e we naa oaaeoendaeeneeg eee eaenea een eee 


An output message to any station in its 
remote file. 


An input message to any remote fite. The 
destination of the message is indicated by 
the number in the remote.fite.no fieid. 


A togicalack.reply message to the network 
controtier. This message shoutd atlow the 
celevant request to acknowiedge receirt of 
the message via an ack to the station. 


A gooderesuits message to the network 
controller. This message acts like an output 
message except that positive receipt of the 
message by the station produces a 
good.resuits.reply. 


ORIGIN AND FUNCTION 


See Gahan SBSeesenwneaseawsean 


An output message from a remote file whose 
open it approved with participating set to 


wi". 


An input message from one of the following: 


A primary station when the signal 
character is not used. 


A secondary station when the signat 
character designated in the open or 
attach or attach.repiy is the first 
character of the message. 


A cemote file with headers. 


An input tlogicatack message from the network 
controiler. This message is received when a 
request executes a terminate logicatack. If 
the primary has headers» it receives this 
messages otherwise» if there is a secondary 
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file it gets the message. 


05 A good.resutts.repty message froa the network 
controller is received upon successful 
transmission of an output message to a 
Station. The message is receivec oniy if the 
good.eresults bit in the message or station 
was set. If the prisary remote file has 
headers. this message is received by the 
primary files otherwise» the secondary file 
receives it. 


06 A recatled.message from the network 
controtler. Recatted.messages fotlow the 
tecail.reply messages The number of recatied 

messages is indicated in the recattl.reply. 


07 An unprocessed.output message fron the 
network controtiter. when the network 
controlter is DSed» it sends output messages 
to the appropriate controtling remote file 
before sending an EOF. 


The data message format is defined as: 


NC-MCS MCS=NC MCS“USER USER<MCS FIELD LENGTH 
R 


w i R W R | R PIC 
MESSAGE.TYPE * * + * + («) {*) * 99 
VARIANT « & a * & = - 9 
LSN * * * * f («) (*) * 999 
TEXT~SIZE * * + & * C«) («) * 9(4) 
REMOTE-FILE NO * * * t + - -_ 999 
TIME * & Sg 9(7) 
TRAN.NO * - aad 999 
ERROR * & = ad xX 
TALLYS * & * * ~ = 9(9) 
TOGGLES * * * . ad ad 9(8) 
TERMINAL.TYPE x * - - 99 
FILLER X(6) 
TEXT re * #«* * * fa & XCTEXT.SIZE) 


Table 3.1 DATA RECORD FORMAT 


The parenthesized fields in Table 3.1 for user remote files 
indicate the three fieids in the cemote key. The remote key has 
the fotlowing format: 


RSN 9¢€3) 
TEXTASIZE 9€4) 
MESSAGE.TYPE 9€3) 


RSN fis converted to LSN by the remote file interface. 
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The semantics of the fields in the header are: 


VARIANT | A field indicating the following: 


-~- wake program memory resident 

-- make program disk resident 

= cause EOF branch 

-- cause exception branch 

-~ inctude text in good.resuits.reply 


“ana @ 
Ui & ii fi = 
8 
a 


LSN , . The logical station number to which the 
deta belongs. It must be set on output 
and good.results sessagess 


TEXT.SIZE The number of characters in the text 
field. 

REMOTE.-FILE.NO The number of the resote file where the 
message came from or is going to. It 


aust be set on input messages. 


TIME The time in 20~bit counter forraat when 

. ' the network controttler processed the 
messages. 

TRAN.NO The transmission number that belongs to 


the message. 


ERROR A 16-bit field extracted from the result 
descriptor which indicates exception 
conditions. The meaning of the bits of 
this field are as follows (bit O=acst 
significant bit): 


BIT EXCEPTION 
parity error 
buffer overftow 
ead memory parity 
time out 

break 

end of buffer 
floss of DSR 
floss of carrier 
address error 
translate error 
10 format error 

il read not ready 
12-15 not used 


WBAaIAU PWR |e 


TALLY 
TOGGLE 
TERMINAL. TYPE The semantics’ of tatlye toggle and 
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terninal.type are the same as in 
previous releases: the tatiy fietd 
represents the first three station 
tallies in 3-character decimat foraat. 
The toggle fietd represents the first 
eight station toggles as "0" or “1%. 
Ternminat.type is the two-digit 
designation that identifies each class 
of terminatis. 


The character string which is ordinarily 
displayed on the remote screen or the 
focal SPO. 
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CONTROL MESSAGES 


OPEN MESSAGE 


The open message is the mechanism for creating new remote files. 
The operating system receives an open from a program and 
determines that the device is a remote file. A remote fite open 
message is then formutated and passed to the network controtter 
which takes the fotlowing actions: 


1. If the fite is knowne it sodifies the message to indicate 
the appropriate station tists if unknowns the open is 
disapproved with file missing. 


2e Verifies that the open sessage is vatid. If note it 
disapproves the open. 


3e If none of the stations in-the open are assigned to an 
MCS» it approves the open and creates a new remote file. 


4. If some of the stations in the open are assigned to cne 
MCS and the rest are unassigned» it forwards the open 
message to the MCS. 


Se. {If the stations in the open are assigned to sore than one 
MCS» it disapproves the open with file locked. 


6. If the program whose open is being processed was 
- gipwmexecuteds the job number of the program that did the 
Zip will be found in parent.job.nunber. In this case» 
the open is forwarded to the file with headers which 
beilong to the program with the indicated job number. If 

no such fiie exists» then the open is denied. 


Te (If it is a dummy fite with headers but was not 
ziptexecuted by an MCS» the open is approved. 


8. [f it is a dummy file without headers and the prograa was 
mot ziprexecuted by an MCS» it will be disapproved. This 
is done because there is no way to attach stations to the 
remote file after the open. 


QPEN REPLY 


If the open is passed to an MCS» an open.reply is expected. The 
MCS must approve or deny the open. It mayo in addition» modify a 
nuaber of other fields as specified in the diagranm on the open 
format Cunder MCS“k). If a denial is sents» no changes will be 
made» the deniai wiit be forwarded to the operating systea which 
will deny the apen to the opening program. A signal character 


4-2 


BURROUGHS CORPORATION COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP MESSAGE CONTROL SYSTEM INTERFACE 
SANTA BARBARA PLANT Fe Se 2212 S447 (CC) 


indicated in the open.reply enables the station to coamunicate 
with the MCS. If open.etype is output or if participating is set» 
no changes wilt be made to primary or secondary assignments. 


If both participating and headers are set» the open witt be 
disapproved by the network controiter and a close with open.error 


set will be dispatched to the MCS. 


When the network controtler receives an open.reply from an MCS» 
it rechecks ail fietds relevant to itself and the operating 
System. If the MCS made an error in formulating the reply» the 
approvat witl be changed to deniat and a close will be sent to 
the MCS with open.error = "1". Otherwise» the new remote fite 
witl be created and the reply forwarded to the operating systen. 


OPEN WITH HEADERS 


An MCS may approve an open with the headers option set» 
indicating another MCS. At this time» the primary file is the 
file whose open was approved and the secondary file is the fite 
which approved that open. Ail messages whose first character is 
the designated signat character go to the secondary file. Ail 
others go to the prisary file. Thene tf the second MCS approves 
an open with that station or attaches that station to a third 
ferote files the first MCS is teft outs» the second MCS becoses 
the secondary fite and the new remote file becomes the oprinary 
file. 


An exanple of secondary attachment wouid be a station running 
under the illustrative MCS which first signs on to a special MCS 
whichs in turn» retrieves certain types of information frog a 
data base on command and then from the second WCS signs onto an 
inventory review progras. As the user reviews the inventory» he 
may at any time type in his signal character and query his data 
base through the special-purpose MCS. In order to contact the 
ilfustrative MCS» however» he must first sign off from the 
inventory review program. 


An example of a participating open would be a station running 
under the illustrative MCS signs onto a special MCS which forsats 
messages according to terminal typeere sets up formss displays data 
attractively» etces and from this second MCS signs onto the 
invantory review programe The second open is approved with 
participating set to "1". In this case» primary aessages are 
sent to the speciat MCS and secondary messages still go to the 
illustrative MCS. 


DUMMY REMOTE OPEN 


If the MCS approves an open with current stations = 0» then the 
open will be approved with no stations initiaily attached. Each 
gessage directed to that remote fite witt cause the MCP to 
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already in the FIB and establish it if necessary. The sessage 
widl then be processed as usual. This facility allows a renote 


file to be opened with no stations attached initially and 
gwessages then to be sent Cunder direction of the approving MCS) 
to the file without the indicated station having been explicitiy 
attached by the MCS to the remote. file. 


QOPENZOPEN-REPLY FORMAT 


The formats for the open and open.repiy messages are shoun below. 
Included are indications of relevant fieids ana following is an 
explanation of each field’s sneaning. ‘ 


NC-uCcS MCS-NC 

R W R PIC 
MESSAGE.TYPE * * + * . 99 
OPEN.TYPE & * 9 
OPENj~ TIME * * 9CT) 
PARENT. JO8.NO t * 9¢(7) 
PROGRAM. JOB.NO ~ ® * 9¢€7) 
PROGRAM.NAME t ® X€30) 
HEADER.~OPTION & * 9 
FAMILY.~OPTION * * 9 
USE.-REMOTE.KEY ® * 9 
RESIDENT e * * & 9 
USER. REHOTE.FILE.NO * * & 999 
SIGNAL.CHAR * * X 
APPROVE.DENY & Oo 9 
CENTAL.~REASON + * 9 
PARTICIPATING I * 9 
GOOD.RESULTS & ® 9 
MAXe STATIONS ® * 999 
CURRENT.STATIONS a * * a 999 
LIST~YYPE * ® 9 
FILENAME * & X€10) 
PROTOCOL.~TYPE * * 99 
SESSION a * 9999 

a t a * ~~ 999 CCURRENT. 


STATION.LIST 
os STATICNS) 


Table 421 OPEN/OPEN.REPLY 
The semantics of the fields of the open message are as follows: 
OPEN. TYPE Indicates the directions of data flow 
giloned the remote file: 
"1" --= input only 


#2" <= output onty 
"3" == input/output 
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OPEN. TIME 


PARENT. JO8.NO 


PROGRAM. JOB.NO 
PROGRANeNAME 


HEADER-OPTION 
FANILY.OPTION 


USE-REMOTE.KEY 


RESIDENT 


USER »-REMOTEFILE.NO 


SIGNAL.CHAR 


APPROVE.DENY 


DENTAL-REASON 
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The time at which the MCP recognizes the 
file open. 


The job number of the 
Ziprexecuted the prograa 


remote file or 70000000". 


program that 
opening the 


The job number of the program opening 
the remote file. 
The name of the program opening the 


remote fite. 


A bootean indicating whether the file is 
attocated with MCS-type headers and 
functions. 


A boolean indicating whether the file is 
a remote file family Cnot yet 
implemented). 


A boolean indicating whether the file 
includes the key option. The remote.key 
option atiows writes to specific 
Stations and on reads indicates the 
Station which sent the current message. 
for files without headers» stations are 
identified by relative station nuabers 
CRSN*s). 


A vatue indicating what to do ona read 
with no data: 


e1"* -- keep programs in semory 
"2" == roll program out to DISK 
"3" == provide EOF branch 


file number which the 
controtler uses to identify the 
file 
The MCS must not change this 


The togicat 
network 
opening file throughout the renote 
interface. 
fietd. 


Used by the 
identify messages 
from a station. 
character. 


network controtler to 
intended for the MCS 
Blank implies no signal 


Indicates to the operating 
whether the open shoutd be 
“31" implies open approvat. 


syster 
approveds 


Indicates the reason for an open denial. 
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PARTICIPATING 


GOOD.~RESULTS 


MAX.STATIONS 


CURRENT.STATIONS 


LIST.TYPE 


FILENAME 
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A bootean indicating whether the 
approving MCS wilt participate in the 
user program's I/0. It is set by the 
approving MCS and causes all input fros 
the station and. att output frog the 
reaote file to be sent to the approving 
MCS rather than the user progran. No 
changes are made to the primary ofr 
secondary fites of the stations in a 
remote file open with participating set 
to “1°. 


Set by the MCS to indicate that the 
network controlier should return 
good.resuitts messages upon successful 
transmission of data messages to the 
station. 


The number of stations that can be 
attached to a given file. It is set by 
the program attenpting to open the 
remote file as part of the file 
dectaratione. ~~ ; 


The number of stations that are in the 
station.tlist to be originally attached 
to the file. Current.stations equal to 
"Q00° indicates a dummy file. This 
creates a file which only the approving 
MCS Cor any MCS gaining knouledge of its 
remote file mnunber) may taitk tor and 
which stations could diater be attached 
CO0e ; 


Indicates the method by which the user 
program specified his remote file. The 
vatues of this field can be: 


=O" == file nase 
"41" -- station list by name 
2" == station list by LSN 


Type "0° is the only one currently 
taplenented. 


A fietd providing the file name given by 
the user program. This name must match 
@ file name deciared in the file section 
of the NOL progras which generated the 
controller unless the user program was 
executed under controt of an MCS. if 
the file name given does not exist ana 
the user program is under controt of an 
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MCS» then the open will be passed to 
that MCS. However» the file name is not 
aunique file identifier. The stations 
in a given NDL file may be madified seo 
@s to be shared by two reaote files or 
passed on to another remote fite with 
the same nane. In future releases» 
files may aiso be designated by station 
List, so reliarce on file names te 


identify remote files is not 
recommended. 

PROTOCOL.TYPE Indicates the type of remote file 
interconamunication desirea by - the 


application program opening the file. 
Currently the defined vatues are: 


“00° - input messages will be type "01" 

"C1" - input message will be type "50" 
or greater 

(See P. Se 2219 0482» SNCS for an 

example.) 


SESSION | The remote session number associated 
with the application program perforaing 
the open. It is "0000" if there is no 
session association. 


STATION.LIST Contains the tList of stations (by LSN) 
included in the remote file. Each USN 
occupies 3 characters in the tist (See 
CURRENT.~STATIONS above). 


QPEN REVIEW CRITERIA 


when an open is approved without being sent to an MCS» the 
network controlter verifies that: 


Ae There is room in the remote file table as indicated by 
the aax files statement in the NDL declaration section. 


Be Current.stations is tess than or equat to smax.stations; 
if not» it is set to maxestations. 


Ce The following conditions are true: 


le the station exists 
and 2. the adapter is present . 
and 3. the station is appropriates t.éeo that 
ae the old primary is nuit 
or be the old primary does not have headers and the otd 
secondary is null and the open.type is output ("2") 
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O. the file is not a dunny file without headers. 


Before an open is forwarded to an CS» the network controller 
verifies that: 


Ae There is room in the remote file tabie as indicated by 
the max files statement in the NOL declaration section. 


8. Current.stations is tess than or equat to maxestationss 
if note it is set to smax.stations. 


Ce. The ceaote file being opened» if it is a dusmy file» was 
zip~executed by a program with headers. 


De The fotiowing conditions are true: 


1. the station exists 
and 22 the adapter is present 
and 3. the station is appropriates i.e.» that 
ae the primary is null Cnot ail stations) 
or be the primary is the approving MCS 
or ce the primary does not have headers and the 
secondary is the approving MCS 
and 4. the nesting of open approvals and attaches is 
not too deep. 


Before an open.ereply is processed and approved for the user 
program» the network controlier verifies that: 


Ae The open on this remote file was sent for open approval 
Be The MCS set approve.deny to “1% indicating approval 

Ce. Current.stations is tess than or equal to max.stations 
0. Headers and participating are not both set 

E- The foilowing conditions are true: 


1. the station exists 
and 2. the adapter is present 
and 3. the station is appropriates i.é6.s that 
&e the oid primary is nutt 
or be the old primary tis the approving MCS 
or ce the old primary does not have headers and 
the old secondary is the approving MCS 
and 4. the nesting of OPEN approvets and attaches is 
not too deep 
and 5.2 if participating» the primary is the approving MCS 
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AJIAGH MESSAGE 


The attach is a mechanissa whereby new stations are assigned to an 
existing remote file. Whereas the open message allows an initial 
assignment of stations to a new remote file» the attach protocot 
adds stations to the file subsequent to the open. 


There are three important remote files (not necessarily unique) 
associated with an attach. 


i. The attach initiator begins the attach process by writing 
an attach message. Eventuatly he will expect to receive 
‘an attacherecly which will either approve or deny the 
attach. The station list may be modified if the attach 
is forwarded to another MCS for approvai so it may be 
necessary to review ‘the station list in processing the 
corpleted attach. 


2. The attach object is the remote file toa which the 
Stations are being attached. If the attach object is not 
the attach initiator» the open of the attach object nust 
have been approved by the attach initiator. The attach 
object may or may not have headers. In either case» it 
teceives no indication of the attach within the attach 
protocols» but may become aware of the attach via the 
inclusion of new stations in its normal message flows via 
@ rerote.file.info» or via a user=aefined convention. 


3e The controitling remote file (CRF) of a station is the 
file with headers to which the station was most recently 
attached Cor included in an open). If the primary has 
headers» it is the CRFs otherwise» the secondary file is 
the CRF if ane exists. 


If the CRF of each station in the station.list is the attach 
initiator or nutle the attach is immediately processed and an 
attach.reply sent back to the attach initiator. The signat 
character specified in the attach will direct control sessages to 
the attaching file for ait the stations he controls. 


If the controlling remote file for the stations in the attach is 
acesote file other than the attach initiators the attach nessage 
is forwarded to the CRF and an attachereply is expected in 
response. The CRF must approve or deny the attach and may modify 
the station tist of the attach. He aiso. specifies the signat 
Character for atl stations he controis. This attach.reply is 
then reviewed by the NC» which either approves the entire attach 
and processes it or dentes it. In either cases the attach.ereply 
is then sent on to the attach initiator. If another MCS approvea 
the attach but the NC denied its a detach is also sent to the CRF 


BURROUGHS CORPORATION 
COMPUTER SYSTEMS GROUP 
SANTA BARBARA PLANT 


4-9 


COMPANY CONFIDENTIAL ° 


MESSAGE CCNTRCL SYSTEM INTERFACE 


with attach.reptly.in.error set to "1%. 


Pe Se 2212 5447 (C0) 


Ifa station is unattached» it may be inctuded in an attach. 


Howevers when 


widd be assigned. 


the attach is processed by the NC» no secondary 


if the stations in the station.list have more than one CRF»e the 
attach will be denied by the network controtlier. 


AITACH TABLE 


Following is a 


the issuance of 


attach.reptly. 


attach and after 


table indicating the status of a station before 


receipt of - an 


Participating or output~onty stations are not 


included in the table because stations attached in those tue 
classes do not change primary and secondary assignuents. 


p= prinary fite 


$ = secondary file 


‘self = attach initiator Cheaders) 
CRF = controlling remote file (not setf) Cheaders) 
user = remote file whose open was approved by setf Cno headers) 


CURRENT STATUS 


unattached 


p=znuil, s=null 


attached to self 


p=setf 


attached to CRF 


p=CRF 


ATTACH T0 SELF 


Bees nee eonewe 2 OS ea 


status if approved 


p=self» s=null 
signai.char ignored 
attacherepty from AC 


p=setf 
Signat.char ignored 
attach.reply from NC 


p=self» s=CRF 


attach.repty sigechar 
attach.reply from CRF 


attached to file without headers 


PDE OOOH SOE EBDSEBSE WSEAS OGB a’ eae 


pzusere s=nuil 


p=usere s=sel f 


attach denied by NC 
p=usere s=nuit 
attach.reply from NC 


p=users s=self 


ATTACH TO OTHER FILE 


Status if approved 


p=others s=null 
Signal.char ignored 
attach.ereply from NC 


p=others. s=self 
attach signat.char 
attach.reptly from NC 


p=other» s=CRF 
attach.reply sig.char 
attach.reply from CRF 


attach denied by NC 
p=usere s=null 
attach.reply from NC 


p=others s=self 
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signal.char iqnored attach signat.char 


attach.reply from KC attach.reply froa NC 


p=usere s=CRF p=setfs» s=CRF- | p=others s=sel f 
attach.reply sigechar attach.repiy sig.char 
attachereply from CRF attach.repiy fro CRF 


MCS°NC NC-CRF 

Ww. OUR W R PIC 
MESSAGE.TYPE + * tt 99 
USER~REMOTE.FILE.NO + * ft 999 
ATTACHING. REMOTE.FILE-NO * & 999 
SIGNAL.~CHAR * e X 
APPROVE.DENY 9 
DENIAL.~REASON 9 
PROGRAM. JOB.NO * * 9¢€7) 
ATTACH. TIME | & 9(7) 
CURRENT-STATIONS © + * & 999 
FILLER X(€6) 
LSN.LIST + * * (9998 

Table 4.2 ATTACH 

MCS - attach initiator 
CRF - controlting resote file 

CRF -NO , NC-MCS 

Wl R W R PIC 
MESSAGE.TYPE + * * « 99 
USER~REMOTE.FILE.NO * * 999 
ATTACHING. REMOTE.FILE.NO * * * 999 
SIGNAL.~CHAR * * . xX 
APPROVE.DENY * * & * 9 
DENTAL-REASON : * * 9 
ATTACH. TIME * * 9(7) 
CURRENT.STATIONS a & * 999 
FILLER . X(6) 
LSN.LIST & * & C999 8 


Table 4.3 ATTACH-REPLY 


The semantics of the fieitds in the attach and attach.reply 
@essages are similar to the open with the fol@dowing exceptions: 


ATTACHING.REMOTE.FILE.NO The file number of the MCS originating 
the attach or attach.reply. It is set 
by the network controller before 
forwarding the message to another MCS. 


SIGNAL.CHAR Set by the controlling resote fite. It 


BURROUGHS CORPORATION 
COMPUTER SYSTEMS GROUP 
SANTA BARBARA PLANT 


4-11 


CCMPANY CONFIDENTIAL 
MESSAGE CCNTRCL SYSTEM INTERFACE 


is used by the network controller to 
identify messages intended for the 
secondary file of a station. Blank 
iapties no signat character. For 
previousty unattached stations and 
Stations whose .CRF fs attaching to 
hinsei f» the signal character is 
. ignored. 


DENIAL-~REASON Set 
! attach is denied. It may have the 
folfoning vatues: 


PROGRAM. JOB.NO On 


eye 
woe 
aja 
“ae 
ge 
*"¢@ 
“7e 


wae 
wge 


an 


by the network controller when an 


invatid remote file 


file Locked 

adapter missing 

CRF denied the attach 

Cnot used) 

invalid LSA in tist 

too many MCS*s for one of the stations 
Cthe nesting of the opens and attaches 
is too deep). 

attach.reply error 

too many stations in file 


attach is the job number of the 


owner of the attaching remote file. On 
attach.reply this witt be the job 
nuaber of the controtting remote file. 
this fietd corresponds to ones oun 
file upon receiving an attach.repty» the 


an 


If 


attach 


was approved oy the network 


controtler onty. 


ATTACH REVIEW CRITERIA 


Before an attach is approved without being sent to another MCS» 
the network controtler verifies that: 


Ae 
Bo 


Ce 


The renote file exists Cuser.remote.fiie.no is valid) 


The attach initiator approved the open of the remote file 
or the attach initiator is the user remote file 


Current.estations ¢ the stations already attached to the 
file is dess than or equal to max.stations for that file 


The following conditions are true: 


1. the station exists 
and 2.2 the adapter is present 
and 3. the statian is appropriates t.@.» that 
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Before 


ae the old prizary is null 
or be the old primary is the attach initiator 
or ce the old primary does not have headers and 
~ the old secondary is the attach initiator 


and 44 the nesting of open approvwats and attaches is 
not too deep 

and 5. if the file is indicated as participatings the 
primary is the attach initiator 


an attach is sent on to the controfting remote file (not 


the attach initiator) for approval, the network controtier 
verifies that: ; 


Ae 
Bo 


Ce 


De 


Before 


The remote file exists Cuser.remote.file.no is vatid) 


The attach initiator approved the open of the remote file 
or the attach initiator is the user resote file 


Current.stations #¢ the stations already attached to the 
file is Less than or equal to max»stations for that file 


The following conditions are true? 


1. the station exists 
and 2. the adapter is present 
and 3. the station is appropriates i.e.» that 


ae the old primary is null Cnot alt stations) 
or be the old primary is the controtiing remote file 
or ce the old primary does not have headers anc the 
oid secondary is the controtling remote fite 


and 44 the nesting of open approvals and attaches is 
not too deep 


an attach.reply is processed and approved for the attach 


initiators the network controller verifies that: 


Ae 
Be 
C. 
De 


Ee 


The vremote file exists Cuser.remote.file.no is valid) 
The attach was forwarded to the CRF for approvat 
The CRF set approve.deny to "1" indicating approval 


Current.stations # the stations already attached to the 
file is less than or equal to nax.stations for that file 


The following conditions are true: 
1. the stations exist 


and 2e the adapter is present 
and 3. the station is appropriates i.@€.» that 
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or be. the 
or ce the 
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old primary its nuit 

old primary is the controiling remote file 
old primary does not have headers and the 
secondary is the controiling remote file 


and 42 the nesting of open approvals and attaches 
is not too deep . 
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DETACH MESSAGE 


The detach is related to the close in the same way that attach is 
telated to the open message. It is proviced for negating the 
effect of an attach» removing stations froa the station list of a 
remote file and returning thea to their previous owners. 


If the user.remote.file.no is vatid> the detach wilt be 
processed» Station by station»s according to the fotlowing 
criteria: 


fe A file may detach a station from itself. é$If there is a 
file which approved the open of that file» it is notified 
via the detach sessage forwarded by the network 
controlter. This indicates to the receiving file that it 
is now the prisary file again. 


2. A file may detach a station from a file whose attach or 
open it approved. 


3. Mhen a station is detached from the remote file 
specified» it is also detached fros att files to which it 
had subsequentiy become attached. 


&e When an attachereply has an errors a detach message is 
sent to the CRF with the attach.repiy.ineerror field set. 


This atlows for three different detach messages: 


1. Messages sent by a remote file with headers to detach a 
Station from its fite or a directly subordinate file. 
These detach messages wilt be responded to with a 
detach.reply from the network controller» the LSN list 
indicating stations actuaily detached. 


2e Messages sent by the network controller to notify an MCS 
that it now controts a tlist of stations. No detachereptly 
is necessary. 


3 Messages sent by the network controiler to notify a CRF 
writing an attachereply that the attach.reply had an 
error and the attach did not get processed. No 
detachereply is necessary. 
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The following is the fornat of the detach message? 


MCS“NC NC*MCS | 
w R W R PIC 
HESSAGE.TYPE e 8 ® & 99 
USER. REMOTE. FILE-NO + ® ® * 999 
ATTACH. REPLY~IN-ERROR & * 9 
CURRENT~STATIONS ¢ ® * ® 999 
FILLER x(6) 
LSN.LIST ¢ * & * (9998 


Table 4e4 DETACH/DETACH-REPLY 


The semantics of the fields of the detach and detach.ereply 
messages are the same as fieids in the OPEN message with the 
exception: | 


AFTACHAREPLY/~IN~ERROR A bootean whichs when set to *"1">» 
indicates that the attach.reply 
was in error. 
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CLOSE MESSAGE 


The close message is provided as a negation to the open message. 
Close messages originate fron the operating system and are passed 
to the remote file which approved the file open. Aliso» a close 
Bay be initiated by the network controlter if an open.erepty 
approving an open was in error (See OPEN). The close sessage 
fequires no reply. 


If an MCS closes its file» the files whose opens it approved will 


atso be closeda. They wuiil receive no new messages. An 
end-of-file message is queued after the tast currently-queued 
message. The stations are relegated to the primary/secondary 


configuration which existed before the closed file was opened. 
The one exception to the above rule is when an MCS participates 
‘dn user program I/0» a close on the remote file does not alter 
the primary and secondary files for the station. 


Fotlaouing is the format for the close message: 


NC NCS 

i R PIC 
MESSAGE.TYPE * * ne. i, Deemereess 
CLOSE.~TIME * 9¢€7) 
RAM * * 9€7) 
USER REMOTE~FILE.NO * * 999 
OPEN. ERROR * * 9 
CURRENT.STATIONS * ® 999 
FILLER XC6) 
LSN.LIST * * C999)# 


Table 4.5 CLOSE 


The semantics of the fields in the close message are sinilar to 
the open message with the exception: 


GPEN. ERROR A boolean set by the network controiler 
to indicate that an MCS open approval 
was invalid. 
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SIAIUS MESSAGE 


Status is now only applicable to stations. The format of the 
Station status/status.reply message is as foilows: 


MCS-NC NC-MCS 

Ww R W R PIC 
MESSAGE.TYPE + * *  « 99 
LSN + & & 999 
REQUESTING LSN & ff 999 
STATUS»ERROR - - * * 9 
STATION.NAME - - * * X€10) 
STATION.READY - - 2 & 9 
STATIONS ENABLED - - & & 9 
STATION.MYUSE - - * * 9 
STATION. TERMINAL TYPE - - oF * 99 
STATION. SUFFERSIZE - - & & 9(5) 
STATION. TRAN-NO-SIZE - - * 9 
STATLON. TRAN-RECEIVE - - * ® XXX 
STATION. TRANe TRANSMIT. - - ® ® XXX 
STATION. RECEIVE. ADOR.SIZE - ‘. ® oI 99 
STATION TRANSMIT.~ADDReSIZE - - * * 99 
STATION. ADDReRECEIVE - - & & X€20) 
STATION. ADOR~TRANSMIT - - ® * X(20) 
STATION. MAXSRETRIES - - t 999 
STATION-PRIORITY.RECEIVE - - & * 999 
STATION.-PRIORITY. TRANSMIT - ° & 999 
MESSAGE.-COUNT - - & * 9(4) 
OLAGNOSTIC.~REQ.ON - - * t 9 
LOGICALACK.ON - - . « 9 
GC0O0D.RESULTS~.ON - - * * 9 
STATION. TALLIES - = & 9(9) 
STATION. TOGGLES - : & * 978) 
STATION. REMOTE.FILE - - « * 999 
REMOTEFILEsHASeHEADERS - - & * 9 
STATION’PHONE - - ® * KC€20) 
STATION. VALID - - * * 9 
STATION-LINE.NO - - & 99 
STATION. SECONDARY.FILE.NO - - * * 999 
FILLER K(10) 
LINE.COUNT - - 2 * 99 
LINE. INFO - * (999 )# 

LINE #& 99 
ACU 9 


Table 4.6 STATION STATUS REQUEST/REPLY 


It is noted that only sessage-.type and LSN fields are required 
for a valid status BESSAGRe 


» 
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The semantics of the status message fietds are as follows: 


USN . The togicat station nuaber of the 
station» the status of which is 
requested/provided. 


REQUESTING-LSN Provided for designating the station 
requesting the inforsation. It is not 
required to be valid. 


STATUS. ERROR Returned from the network controiler and 
is "1" except when the LSN provided in 
the status request was invalids in which 

case it is "0". 


STATION NAME Through diagnostic.req.on provides the 
sase information as the station status 
reply message of previous releases» but 
in character format. 


STATION. TALLIES 

STATION. TOGGLES Provides tatlies O-2 and toggles O-7 in 
the same format as the data message. 

STATION.REMOTE.~FILE Indicates the nusber of the renote file 


to which normal input is atttached. 


REMOTE~FILEeHASeHEADERS Indicates whether the above remote file 
was opened by an #CS-type progran. 


STATION.LINE.NO The current tine assignment for the 
. station. 


STATION.~SECONDARY.FILE-NO The renote file number of the station®s 
secondary. If it is "000%. then there 
is no secondary. 


LINE.~COUNT The number of tines on which the station 
. ts defined. 


LINE. INFO | Line.count 3-character fields dascribing 
the tine nusber (char 2) and its 
essociated diatout status boolean (char 
1). 


A program with remote file headers may send a status message and 
receive a corresponding status reply. 
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subject to change are station change 


parameters. Line attributes are opaque to an MCS. 


The format of the change and change-reptly is as follows: 


MESSAGE.TYPE 
USN 
REQUESTING.LSN 
CHANGE.TYPE 
CHANGE.RESULT 
CHANGE. VALUE 


MCS<-NC NC-MCS PIC 

¢ & * * 99 

+ & * 999 

* « XXX 

+ * ® 99 

a & 9 

+ * * XC€20) or 
XXX or 
999 or 
9 


(See chart below.) 


Table 4.7 CHANGE/CHANGE «REPLY 


The semantics of the change nessage are as follows: 


SN 


REQUESTING.LSN 


CHANGE.TYPE 


CHANGE TYPE 
”oQe* 
*o1" 
“OQ? 
*9Q3° 
"04% 
“Q5° - 
"06" 
“97° 
"oa" 
"09" 
"10° 
"11° 
“) 2” 


The station whose parameter is to be 
changed. 


An optional field provided for the LSN 
of the station directing the change. 
This fietd is not used by the network 


controtter and can contain information 


in any format desired. 


Indicates the field to be change ds The 


gweanings are: 


FIELD VALUE FORMAT 


TRANCRECEIVE) | XXX 
TRANCTRANSMIT) XXX | 
ADORESSCRECE IVE) X€20) 
ADDRESSCTRANSF#FIT) X(20) 
FREQUENCYCRECEIVE) 999 
FREQGUENCYCTRAASMIT) 999 
MAXeRETRY 999 
ENABLED | 9 
READY 9 
OIFAGNOSTIC.ON 9 
LOGICALACK.ON 9 
GOODRESULTS.ON 9 
STATION.PHONE X(20) 
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CHANGE.RESULT AGtarns “1° u tess there was an error in 

Che _sessage "0" implies an invatid 

. LSN. 2" japlies an invalid change 
type. 


CHANGE. VALUE The field*’s new vatue in Left-justified 
char acter format. 
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RECALL MESSAGE 


REMOVE MESSAGE 


The recatt anessage is provided for reroving any nusber cf 
messages from the top of a station*®s output queues sarking thes 
as recalled.messages» and sending thems prefixed by a 
eecail.ceply message» to the MCS. The recall.repiy contains the 
nugber of sessages to foilow. 


The remove message is provided for rersoving any number of 
messages from the top of a station's queue. The network 
controtler will always respond with a remove.reply indicating the 
nuaber of messages actuaily removed. 


A cautionary note: when using recall and remover it is best to 
wake the station not ready first as otherwise the first smsessage 
gay or gay not be included» depending on whether the station is 
currently being processed. 


Recatil»> recali.reptly>» remove and remove.reply messages are 
forsatted as foitouws: 


MCS<NC NC-NCS 

W R | R PIC 
MESSAGE.~TYPE + * * * 99 
LSN + * * 999 
REQUESTING.LSN t * 999 
MESSAGE.COUNT +t tt & & 9€&) 
RECALL.»ERROR * 9 

Table 4.8@- RECALL/RECALL «REPLY 

The semantics of the RECALL format are as follows: 
LSN The station from whose output queue the 


messages are to be recattied or resgoved. 


REQUESTING.LSN This fietd indicates the station 
tnitiating the recalt or resove. 


MESSAGE~COUNT | Originatly the number of sessages to be 
recatled/s removed ("001" for one», 7999" 
for all) and in the reply» the nusber of 
messages actuaily recatled/renoved. 


RECALL~ERROR Set to "1L” if the message is improperly 
formulated. 
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A recall will place the recalledsmessages iasediately following 
the recail.reptly. | 
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REMOTESFILE-INEQ MESSAGE © 


An MCS-type programs sway control a set of stations by opening a 
fesote file with the header option. In order to provide 
necessary inforsgation about the file just acquired» the 
fenote.file~info/resote.file.info.reply protocot is provided. 
The format is as fotlows: 


MCS<NC NC-MCS 

W oR W R PIC 
MESSAGE.TYPE + * « * 99 
JOB.NO * * 9C€7) 
TINE * * 9(7) 
REMOTE~FILE.~NO (a) « 2. w 999 
OQUTPUT.MESSAGES.QUEUED * * 9¢€4) 
INPUT.MESSAGES.QUEUVED * ® 9¢€4&) 
CURRENT.STATIONS * t 999 
OQTHERRFeREQLEST * a gy 
OTHER.RF.ERROR . * & 9 
OPEN. APPROVER.RF.NO | tk & 99 
FILLER : , 99 
LSN.LIST ® * (9998 
OUTPUT.QUEULED.LIST -_ * (9998 


(*) Mandatory only if QTHER.RF-REQUEST is "1". 
Tabie 4.9 REMOTE-FILE-INFO/REPLY 


It is noted that only message.type is required for a vatid 
resote.file.info inquiry on the file originating the inquiry. 


The semantics of the remaining fields sre as follows: 


JOB.NO Jobcnunaber of the MCS*type file. 

TIME The time that the reply was sent. 

REMOTE-FILE-NO The number of your remote file if 
| other.rf.request is "0". It is the 


nuaber of the target resote fite if 
other.rferequest is "1". 


OQUTPUT.~MESSAGES.~QUEUED The totat of ail messages queued (for 
output to ali stations in the file. 


INPUT-MESSAGES.~QUEUED The totat of att messages queued fron 
alt stations that are destined to be 
tead by your file. 


CURRENT.STATIONS The nusber of stations attached to the 
file. 


BURROUGHS CORPORATION 
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OTHER SRFeREQUEST 
OTHER ~RFERROR 
OPEN.~jAPPROVER-RF.NO 


LSN-LIST 


OUTPUT.QUEUVED.LIST 
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"0" if the request is for the writing 
MCS*s file. It is "1" if remote.file.no 
contains the fite number about which 
information is requested. 


"1" in the repty is the requestor had 
set other.rf.request to "1" and the 
remnote.file.no supplied was 
non-existent. 


The remote file number of the MCS which 
approved the requestor*s open. 


Has an LSN for every current station. 
Has the output messages for each of the 


current stations. It should totai_ to 
output.messages.-queued. 
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USER MESSAGES 


An executing MCS say interface with a user remote file without 
headers through the fotlowing record format: 


MCS“USER USER@-MCS FIELO-LENGTH 

W R W R PIC 
MESSAGE.TYPE 4 e * * 99. 
FILLER * o & 9 
LSN * * * * 999 
TEXT~SIZE ¢ & * Ps 9(4&) 
REMOTE-FILENO + ® & 999 
TEXT t * % KCTEXT-SIZE) 


Table 5.1 USER-DEFINED MESSAGE 


The semantics of the fields of the USER-DEFINED message record 
are: 


MESSAGE.TYPE Established by the user program and sust 
. be a number greater than 49 and tess 
than 100. 
LSN The logical station nusber to which the 
: data belongs. | 
TEXT.SIZE | The number of characters in the text 
field. 
REMOTE~FILE.NO | The number of the resote file where the 


message came from or is going to. 


TEXT The char acter string which is ordinarily 
displayed on the remote screen or the 
local SPO. 
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